home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / gdb-4.5 / dist / include / coff / internal.h < prev    next >
Encoding:
C/C++ Source or Header  |  1992-01-28  |  15.6 KB  |  444 lines
  1. /* Internal format of COFF object file data structures, for GNU BFD.
  2.    This file is part of BFD, the Binary File Descriptor library.  */
  3.  
  4. /* First, make "signed char" work, even on old compilers. */
  5. #ifndef signed
  6. #ifndef __STDC__
  7. #define    signed    /**/
  8. #endif
  9. #endif
  10.  
  11. /********************** FILE HEADER **********************/
  12. struct internal_filehdr 
  13. {
  14.   unsigned short    f_magic; /* magic number            */
  15.   unsigned short    f_nscns; /* number of sections        */
  16.   long        f_timdat;    /* time & date stamp        */
  17.   long        f_symptr;    /* file pointer to symtab    */
  18.   long        f_nsyms;    /* number of symtab entries    */
  19.   unsigned short    f_opthdr; /* sizeof(optional hdr)        */
  20.   unsigned short    f_flags; /* flags            */
  21. };
  22.  
  23. /* Bits for f_flags:
  24.  *    F_RELFLG    relocation info stripped from file
  25.  *    F_EXEC        file is executable (no unresolved external references)
  26.  *    F_LNNO        line numbers stripped from file
  27.  *    F_LSYMS        local symbols stripped from file
  28.  *    F_AR16WR    file is 16-bit little-endian
  29.  *    F_AR32WR    file is 32-bit little-endian
  30.  *    F_AR32W        file is 32-bit big-endian
  31.  *    F_DYNLOAD    rs/6000 aix: dynamically loadable w/imports & exports
  32.  *    F_SHROBJ    rs/6000 aix: file is a shared object
  33.  */
  34.  
  35. #define    F_RELFLG    (0x0001)
  36. #define    F_EXEC        (0x0002)
  37. #define    F_LNNO        (0x0004)
  38. #define    F_LSYMS        (0x0008)
  39. #define    F_AR16WR    (0x0080)
  40. #define    F_AR32WR    (0x0100)
  41. #define    F_AR32W         (0x0200)
  42. #define    F_DYNLOAD    (0x1000)
  43. #define    F_SHROBJ    (0x2000)
  44.  
  45. /********************** AOUT "OPTIONAL HEADER" **********************/
  46. struct internal_aouthdr {
  47.     short        magic;    /* type of file                */
  48.     short        vstamp;    /* version stamp            */
  49.     unsigned long    tsize;    /* text size in bytes, padded to FW bdry*/
  50.     unsigned long    dsize;    /* initialized data "  "        */
  51.     unsigned long    bsize;    /* uninitialized data "   "        */
  52.     unsigned long    entry;    /* entry pt.                */
  53.     unsigned long    text_start;    /* base of text used for this file */
  54.     unsigned long    data_start;    /* base of data used for this file */
  55.  
  56.     /* i960 stuff */
  57.     unsigned long    tagentries;    /* number of tag entries to follow */
  58.  
  59.     /* RS/6000 stuff */
  60.         unsigned long   o_toc;    /* address of TOC            */
  61.         short        o_snentry;    /* section number for entry point */
  62.         short        o_sntext;    /* section number for text    */
  63.         short        o_sndata;    /* section number for data    */
  64.         short        o_sntoc;    /* section number for toc    */
  65.         short        o_snloader;    /* section number for loader section */
  66.         short        o_snbss;    /* section number for bss    */
  67.         short        o_algntext;    /* max alignment for text    */
  68.         short        o_algndata;    /* max alignment for data    */
  69.         short        o_modtype;    /* Module type field, 1R,RE,RO    */
  70.         unsigned long   o_maxstack;     /* max stack size allowed.    */
  71. };
  72.  
  73. /********************** STORAGE CLASSES **********************/
  74.  
  75. #define C_EFCN        -1    /* physical end of function    */
  76. #define C_NULL        0
  77. #define C_AUTO        1    /* automatic variable        */
  78. #define C_EXT        2    /* external symbol        */
  79. #define C_STAT        3    /* static            */
  80. #define C_REG        4    /* register variable        */
  81. #define C_EXTDEF    5    /* external definition        */
  82. #define C_LABEL        6    /* label            */
  83. #define C_ULABEL    7    /* undefined label        */
  84. #define C_MOS        8    /* member of structure        */
  85. #define C_ARG        9    /* function argument        */
  86. #define C_STRTAG    10    /* structure tag        */
  87. #define C_MOU        11    /* member of union        */
  88. #define C_UNTAG        12    /* union tag            */
  89. #define C_TPDEF        13    /* type definition        */
  90. #define C_USTATIC    14    /* undefined static        */
  91. #define C_ENTAG        15    /* enumeration tag        */
  92. #define C_MOE        16    /* member of enumeration    */
  93. #define C_REGPARM    17    /* register parameter        */
  94. #define C_FIELD        18    /* bit field            */
  95. #define C_AUTOARG    19    /* auto argument        */
  96. #define C_LASTENT    20    /* dummy entry (end of block)    */
  97. #define C_BLOCK        100    /* ".bb" or ".eb"        */
  98. #define C_FCN        101    /* ".bf" or ".ef"        */
  99. #define C_EOS        102    /* end of structure        */
  100. #define C_FILE        103    /* file name            */
  101. #define C_LINE        104    /* line # reformatted as symbol table entry */
  102. #define C_ALIAS         105    /* duplicate tag        */
  103. #define C_HIDDEN    106    /* ext symbol in dmert public lib */
  104.  
  105.     /* New storage classes for 80960 */
  106.  
  107. /* C_LEAFPROC is obsolete.  Use C_LEAFEXT or C_LEAFSTAT */
  108. #define C_LEAFPROC    108    /* Leaf procedure, "call" via BAL */
  109.  
  110. #define C_SCALL        107    /* Procedure reachable via system call */
  111. #define C_LEAFEXT       108    /* External leaf */
  112. #define C_LEAFSTAT      113     /* Static leaf */
  113. #define C_OPTVAR    109    /* Optimized variable        */
  114. #define C_DEFINE    110    /* Preprocessor #define        */
  115. #define C_PRAGMA    111    /* Advice to compiler or linker    */
  116. #define C_SEGMENT    112    /* 80960 segment name        */
  117.  
  118.     /* New storage classes for RS/6000 */
  119. #define C_HIDEXT        107     /* Un-named external symbol */
  120. #define C_BINCL         108     /* Marks beginning of include file */
  121. #define C_EINCL         109     /* Marks ending of include file */
  122.  
  123.     /* storage classes for stab symbols for RS/6000 */
  124. #define C_GSYM          ((signed char)0x80)
  125. #define C_LSYM          ((signed char)0x81)
  126. #define C_PSYM          ((signed char)0x82)
  127. #define C_RSYM          ((signed char)0x83)
  128. #define C_RPSYM         ((signed char)0x84)
  129. #define C_STSYM         ((signed char)0x85)
  130. #define C_TCSYM         ((signed char)0x86)
  131. #define C_BCOMM         ((signed char)0x87)
  132. #define C_ECOML         ((signed char)0x88)
  133. #define C_ECOMM         ((signed char)0x89)
  134. #define C_DECL          ((signed char)0x8c)
  135. #define C_ENTRY         ((signed char)0x8d)
  136. #define C_FUN           ((signed char)0x8e)
  137. #define C_BSTAT         ((signed char)0x8f)
  138. #define C_ESTAT         ((signed char)0x90)
  139.  
  140. /********************** SECTION HEADER **********************/
  141. struct internal_scnhdr {
  142.     char        s_name[8];    /* section name            */
  143.     long        s_paddr;    /* physical address, aliased s_nlib */
  144.     long        s_vaddr;    /* virtual address        */
  145.     long        s_size;        /* section size            */
  146.     long        s_scnptr;    /* file ptr to raw data for section */
  147.     long        s_relptr;    /* file ptr to relocation    */
  148.     long        s_lnnoptr;    /* file ptr to line numbers    */
  149.     unsigned long     s_nreloc;    /* number of relocation entries    */
  150.     unsigned long   s_nlnno;    /* number of line number entries*/
  151.     long        s_flags;    /* flags            */
  152. #ifdef I960
  153.     long        s_align;    
  154. #endif
  155. };
  156.  
  157.  
  158. /*
  159.  * s_flags "type"
  160.  */
  161. #define STYP_REG     (0x0000) /* "regular": allocated, relocated, loaded */
  162. #define STYP_DSECT     (0x0001) /* "dummy":  relocated only*/
  163. #define STYP_NOLOAD     (0x0002) /* "noload": allocated, relocated, not loaded */
  164. #define STYP_GROUP     (0x0004) /* "grouped": formed of input sections */
  165. #define STYP_PAD     (0x0008) /* "padding": not allocated, not relocated, loaded */
  166. #define STYP_COPY     (0x0010) /* "copy": for decision function used by field update;  not allocated, not relocated,
  167.                      loaded; reloc & lineno entries processed normally */
  168. #define STYP_TEXT     (0x0020) /* section contains text only */
  169. #define S_SHRSEG     (0x0020) /* In 3b Update files (output of ogen), sections which appear in SHARED segments of the Pfile
  170.                      will have the S_SHRSEG flag set by ogen, to inform dufr that updating 1 copy of the proc. will
  171.                      update all process invocations. */
  172. #define STYP_DATA     (0x0040) /* section contains data only */
  173. #define STYP_BSS     (0x0080) /* section contains bss only */
  174. #define S_NEWFCN     (0x0100) /* In a minimal file or an update file, a new function (as compared with a replaced function) */
  175. #define STYP_INFO     (0x0200) /* comment: not allocated not relocated, not loaded */
  176. #define STYP_OVER     (0x0400) /* overlay: relocated not allocated or loaded */
  177. #define STYP_LIB     (0x0800) /* for .lib: same as INFO */
  178. #define STYP_MERGE     (0x2000) /* merge section -- combines with text, data or bss sections only */
  179. #define STYP_REVERSE_PAD (0x4000) /* section will be padded with no-op instructions wherever padding is necessary and there is a
  180.                      word of contiguous bytes beginning on a word boundary. */
  181. /********************** LINE NUMBERS **********************/
  182.  
  183. /* 1 line number entry for every "breakpointable" source line in a section.
  184.  * Line numbers are grouped on a per function basis; first entry in a function
  185.  * grouping will have l_lnno = 0 and in place of physical address will be the
  186.  * symbol table index of the function name.
  187.  */
  188.  
  189. struct internal_lineno {
  190.     union {
  191.         long l_symndx;    /* function name symbol index, iff l_lnno == 0*/
  192.         long l_paddr;    /* (physical) address of line number    */
  193.     } l_addr;
  194.     unsigned long    l_lnno;    /* line number        */
  195. };
  196.  
  197.  
  198. /********************** SYMBOLS **********************/
  199.  
  200. #define SYMNMLEN    8    /* # characters in a symbol name    */
  201. #define FILNMLEN    14    /* # characters in a file name        */
  202. #define DIMNUM        4    /* # array dimensions in auxiliary entry */
  203.  
  204. struct internal_syment {
  205.     union {
  206.         char    _n_name[SYMNMLEN];    /* old COFF version    */
  207.         struct {
  208.             long    _n_zeroes;    /* new == 0        */
  209.             long    _n_offset;    /* offset into string table */
  210.         } _n_n;
  211.         char    *_n_nptr[2];    /* allows for overlaying    */
  212.     } _n;
  213.     long        n_value;    /* value of symbol        */
  214.     short        n_scnum;    /* section number        */
  215.     unsigned short    n_flags;    /* copy of flags from filhdr    */
  216.     unsigned short    n_type;        /* type and derived type    */
  217.     signed char    n_sclass;    /* storage class        */
  218.     char        n_numaux;    /* number of aux. entries    */
  219. };
  220. #define n_name        _n._n_name
  221. #define n_zeroes    _n._n_n._n_zeroes
  222. #define n_offset    _n._n_n._n_offset
  223.  
  224.  
  225. /* Relocatable symbols have number of the section in which they are defined,
  226.    or one of the following: */
  227.  
  228. #define N_UNDEF    ((short)0)  /* undefined symbol */
  229. #define N_ABS    ((short)-1) /* value of symbol is absolute */
  230. #define N_DEBUG    ((short)-2) /* debugging symbol -- value is meaningless */
  231. #define N_TV    ((short)-3) /* indicates symbol needs preload transfer vector */
  232. #define P_TV    ((short)-4) /* indicates symbol needs postload transfer vector*/
  233.  
  234. /*
  235.  * Type of a symbol, in low N bits of the word
  236.  */
  237. #define T_NULL        0
  238. #define T_VOID        1    /* function argument (only used by compiler) */
  239. #define T_CHAR        2    /* character        */
  240. #define T_SHORT        3    /* short integer    */
  241. #define T_INT        4    /* integer        */
  242. #define T_LONG        5    /* long integer        */
  243. #define T_FLOAT        6    /* floating point    */
  244. #define T_DOUBLE    7    /* double word        */
  245. #define T_STRUCT    8    /* structure         */
  246. #define T_UNION        9    /* union         */
  247. #define T_ENUM        10    /* enumeration         */
  248. #define T_MOE        11    /* member of enumeration*/
  249. #define T_UCHAR        12    /* unsigned character    */
  250. #define T_USHORT    13    /* unsigned short    */
  251. #define T_UINT        14    /* unsigned integer    */
  252. #define T_ULONG        15    /* unsigned long    */
  253. #define T_LNGDBL    16    /* long double        */
  254.  
  255. /*
  256.  * derived types, in n_type
  257. */
  258. #define DT_NON        (0)    /* no derived type */
  259. #define DT_PTR        (1)    /* pointer */
  260. #define DT_FCN        (2)    /* function */
  261. #define DT_ARY        (3)    /* array */
  262.  
  263. #define BTYPE(x)    ((x) & N_BTMASK)
  264.  
  265. #define ISPTR(x)    (((x) & N_TMASK) == (DT_PTR << N_BTSHFT))
  266. #define ISFCN(x)    (((x) & N_TMASK) == (DT_FCN << N_BTSHFT))
  267. #define ISARY(x)    (((x) & N_TMASK) == (DT_ARY << N_BTSHFT))
  268. #define ISTAG(x)    ((x)==C_STRTAG||(x)==C_UNTAG||(x)==C_ENTAG)
  269. #define DECREF(x) ((((x)>>N_TSHIFT)&~N_BTMASK)|((x)&N_BTMASK))
  270.  
  271.  
  272. union internal_auxent 
  273. {
  274.   struct {
  275.  
  276.     union {
  277.       long l;            /* str, un, or enum tag indx */
  278.       struct coff_ptr_struct *p;
  279.     } x_tagndx;
  280.  
  281.     union {
  282.       struct {
  283.     unsigned short x_lnno;    /* declaration line number */
  284.     unsigned short x_size;    /* str/union/array size */
  285.       } x_lnsz;
  286.       long x_fsize;        /* size of function */
  287.     } x_misc;
  288.  
  289.     union {
  290.       struct {            /* if ISFCN, tag, or .bb */
  291.     long x_lnnoptr;        /* ptr to fcn line # */
  292.     union {         /* entry ndx past block end */
  293.       long  l;
  294.       struct coff_ptr_struct *p;
  295.     } x_endndx;
  296.       } x_fcn;
  297.  
  298.       struct {            /* if ISARY, up to 4 dimen. */
  299.     unsigned short x_dimen[DIMNUM];
  300.       } x_ary;
  301.     } x_fcnary;
  302.  
  303.     unsigned short x_tvndx;    /* tv index */
  304.   } x_sym;
  305.  
  306.   union {
  307.     char x_fname[FILNMLEN];
  308.     struct {
  309.       long x_zeroes;
  310.       long x_offset;
  311.     } x_n;
  312.   } x_file;
  313.  
  314.   struct {
  315.     long x_scnlen;        /* section length */
  316.     unsigned short x_nreloc;    /* # relocation entries */
  317.     unsigned short x_nlinno;    /* # line numbers */
  318.   } x_scn;
  319.  
  320.   struct {
  321.     long        x_tvfill; /* tv fill value */
  322.     unsigned short    x_tvlen; /* length of .tv */
  323.     unsigned short    x_tvran[2]; /* tv range */
  324.   } x_tv;        /* info about .tv section (in auxent of symbol .tv)) */
  325.  
  326.   /******************************************
  327.    * RS/6000-specific auxent - last auxent for every external symbol
  328.    ******************************************/
  329.   struct {
  330.     long            x_scnlen;       /* csect length */
  331.     long            x_parmhash;     /* parm type hash index */
  332.     unsigned short  x_snhash;       /* sect num with parm hash */
  333.     unsigned char   x_smtyp;        /* symbol align and type */
  334.                     /* 0-4 - Log 2 of alignment */
  335.                     /* 5-7 - symbol type */
  336.     unsigned char   x_smclas;       /* storage mapping class */
  337.     long            x_stab;         /* dbx stab info index */
  338.     unsigned short  x_snstab;       /* sect num with dbx stab */
  339.   } x_csect; /* csect definition information */
  340.  
  341. /* x_smtyp values:  */
  342.  
  343. #define    SMTYP_ALIGN(x)    ((x) >> 3)    /* log2 of alignment */
  344. #define    SMTYP_SMTYP(x)    ((x) & 0x7)    /* symbol type */
  345. /* Symbol type values:  */
  346. #define    XTY_ER    0    /* External reference */
  347. #define    XTY_SD    1    /* Csect definition */
  348. #define    XTY_LD    2    /* Label definition */
  349. #define XTY_CM    3    /* .BSS */
  350. #define    XTY_EM    4    /* Error message */
  351. #define    XTY_US    5    /* "Reserved for internal use" */
  352.  
  353. /* x_smclas values:  */
  354.  
  355. #define    XMC_PR    0    /* Read-only program code */
  356. #define    XMC_RO    1    /* Read-only constant */
  357. #define    XMC_DB    2    /* Read-only debug dictionary table */
  358. #define    XMC_TC    3    /* Read-write general TOC entry */
  359. #define    XMC_UA    4    /* Read-write unclassified */
  360. #define    XMC_RW    5    /* Read-write data */
  361. #define    XMC_GL    6    /* Read-only global linkage */
  362. #define    XMC_XO    7    /* Read-only extended operation (simulated insn) */
  363. #define    XMC_SV    8    /* Read-only supervisor call */
  364. #define    XMC_BS    9    /* Read-write BSS */
  365. #define    XMC_DS    10    /* Read-write descriptor csect */
  366. #define    XMC_UC    11    /* Read-write unnamed Fortran common */
  367. #define    XMC_TI    12    /* Read-only traceback index csect */
  368. #define    XMC_TB    13    /* Read-only traceback table csect */
  369. /*         14    ??? */
  370. #define    XMC_TC0    15    /* Read-write TOC anchor for TOC addressability */
  371.  
  372.  
  373.   /******************************************
  374.    *  I960-specific *2nd* aux. entry formats
  375.    ******************************************/
  376.   struct {
  377.     /* This is a very old typo that keeps getting propagated. */
  378. #define x_stdindx x_stindx
  379.     long x_stindx;        /* sys. table entry */
  380.   } x_sc;            /* system call entry */
  381.  
  382.   struct {
  383.     unsigned long x_balntry;    /* BAL entry point */
  384.   } x_bal;            /* BAL-callable function */
  385.  
  386.   struct {
  387.     unsigned long    x_timestamp; /* time stamp */
  388.     char     x_idstring[20];    /* producer identity string */
  389.   } x_ident;            /* Producer ident info */
  390.  
  391. };
  392.  
  393. /********************** RELOCATION DIRECTIVES **********************/
  394.  
  395. struct internal_reloc 
  396. {
  397.     long r_vaddr;        /* Virtual address of reference */
  398.     long r_symndx;        /* Index into symbol table    */
  399.     unsigned short r_type;    /* Relocation type        */
  400.  
  401. #if RS6000COFF_C
  402.     unsigned char  r_size;
  403. #endif
  404.  
  405.     unsigned short r_offset;
  406.  
  407. };
  408.  
  409. #define R_RELBYTE    017
  410. #define R_RELWORD    020
  411. #define R_PCRBYTE    022
  412. #define R_PCRWORD    023
  413. #define R_PCRLONG    024
  414.  
  415. #define R_DIR32        06
  416. #define    R_PCLONG    020
  417. #define R_RELBYTE    017
  418. #define R_RELWORD    020
  419.  
  420.  
  421.  
  422. #define R_PCR16L 128
  423. #define R_PCR26L 129
  424. #define R_VRT16  130
  425. #define R_HVRT16 131
  426. #define R_LVRT16 132
  427. #define R_VRT32  133
  428. #define R_RELLONG    (0x11)    /* Direct 32-bit relocation */
  429. #define R_IPRSHORT    (0x18)
  430. #define R_IPRMED     (0x19)    /* 24-bit ip-relative relocation */
  431. #define R_IPRLONG    (0x1a)
  432. #define R_OPTCALL    (0x1b)    /* 32-bit optimizable call (leafproc/sysproc) */
  433. #define R_OPTCALLX    (0x1c)    /* 64-bit optimizable call (leafproc/sysproc) */
  434. #define R_GETSEG    (0x1d)
  435. #define R_GETPA        (0x1e)
  436. #define R_TAGWORD    (0x1f)
  437. #define R_JUMPTARG    0x20    /* strange 29k 00xx00xx reloc */
  438. #define R_MOVB1    0x41    /* Special h8 16bit or 8 bit reloc for  mov.b */
  439. #define R_MOVB2    0x42    /* Special h8 opcode for 8bit which could
  440.                   be 16 */
  441. #define R_JMP1     0x43    /* Special h8 16bit jmp which could be
  442.                   pcrel */
  443. #define R_JMP2 0x44 /* a branch which used to be a jmp */
  444.